Releases the memory occupied by a picture not stored in a 'PICT' resource.

void KillPicture (
    PicHandle myPicture
);

Parameter descriptions

myPicture

A handle to the picture whose memory can be released.

DISCUSSION

Use this function only when you are completely finished with a picture.

SPECIAL CONSIDERATIONS

If you use the Window Manager function SetWindowPic to store a picture handle in the window structure, use the Window Manager function DisposeWindow or CloseWindow to release the memory allocated to the picture. These functions automatically call KillPicture for the picture.

If the picture is stored in a 'PICT' resource, use the Resource Manager function ReleaseResource instead of KillPicture. The Window Manager functions DisposeWindow and CloseWindow will not delete it. Instead, call ReleaseResource before calling DisposeWindow or CloseWindow.

The KillPicture function may move or purge memory.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)